home *** CD-ROM | disk | FTP | other *** search
/ Aminet 21 / Aminet 21 (1997)(GTI - Schatztruhe)[!][Oct 1997].iso / Aminet / dev / misc / ahidev.lha / AHI / ahidev.readme < prev    next >
Encoding:
Text File  |  1997-08-19  |  4.9 KB  |  144 lines
  1. Short:    Retargetable audio v4.14, Developer's Archive
  2. Type:     dev/misc
  3. Author:   Martin Blom <lcs@lysator.liu.se>
  4. Uploader: Martin Blom <lcs@lysator.liu.se>
  5.  
  6.      This archive contains the developer documentation and
  7.      example source code for AHI, both for programmer who wish
  8.      to use AHI in their own applications and those who want
  9.      to write hardware drivers.
  10.  
  11.      Changes since last release
  12.      ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  13.      Bug fixes.
  14.      The Paula driver can now be told to swap left and right channel.
  15.      Toccata driver updated, should work fine on Draco Motion again.
  16.      Added Melody to the distribution.
  17.  
  18.  
  19.  
  20. TITLE
  21.  
  22.      AHI Audio system
  23.  
  24. VERSION
  25.  
  26.      Release 4
  27.  
  28. AUTHOR
  29.  
  30.      Martin Blom <lcs@lysator.liu.se>
  31.  
  32. DESCRIPTION
  33.  
  34.      Retargetable Audio for AmigaOS
  35.      ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  36.  
  37.      (When refering to this software, the correct term is
  38.      'AHI audio system' or just 'AHI', never 'Audio Hardware
  39.      Interface'! 'AHI' is pronounced 'atchii', as in 'God bless!'.)
  40.  
  41.      Starting with version 3 of AHI, the MC68000 processor is also supported.
  42.      However, many features are lacking:
  43.  
  44.      · Very limited volime control when using 16 bit samples
  45.      · No HiFi mixing routines are available.
  46.      · No stereo samples
  47.      · No DSP effects are available.
  48.      · Less precision on some calculations
  49.      · Slower
  50.  
  51.      As you can see, this version is very primitive.  Get yourself an
  52.      accelerator!  I cannot guarantee that I will continue to support this
  53.      processor in the future.
  54.  
  55.      Quick overview
  56.      ¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  57.  
  58.      * Driver based
  59.  
  60.      Each supported sound card is controlled by a library-based audio
  61.      driver. For a 'dumb' sound card, a new driver should be written in
  62.      a few hours. For a 'smart' sound card, it is possible to utilize an
  63.      on-board DSP, for example, to maximize performance and sound quality.
  64.      For sound cards with own DSP but little or no memory, it is possible
  65.      to use the main CPU to mix channels and do the post-processing
  66.      with the DSP. Available today are drivers for
  67.  
  68.      · Aura (sampler only)
  69.      · Delfina DSP and Delfina Lite
  70.      · DraCo Motion
  71.      · Paula (8/14/14c bit)
  72.      · Prelude
  73.      · Toccata
  74.      · Wavetools
  75.      · 8SVX (mono) and AIFF/AIFC (mono & stereo) sample render
  76.  
  77.      * Fast, powerful mixing routines (yeah, right... haha)
  78.  
  79.      The device's mixing routines mix 8- or 16-bit signed samples, both
  80.      mono and stereo, located in Fast-RAM and outputs 16-bit mono or stereo
  81.      (with stereo panning if desired) data, using any number of channels
  82.      (as long as 'any' means less than 128...).  Tables can be used speed
  83.      the mixing up (especially when using 8-bit samples).  The samples can
  84.      have any length (including odd) and can have any number of loops.
  85.      
  86.      * Support for non-realtime mixing
  87.  
  88.      By providing a timing feature, it is possible to create high-
  89.      quality output even if the processing power is lacking, by saving
  90.      the output to disk, for example as an IFF AIFF or 8SXV file.
  91.      There are so-called HiFi mixing routines that can be used, which
  92.      use linear interpolation and gives 32 bit output.
  93.  
  94.      * Audio database
  95.  
  96.      Uses ID codes, much like Screenmode IDs, to select the many
  97.      parameters that can be set. The functions to access the audio
  98.      database are not too different from those in 'graphics.library'.
  99.      The device also features a requester to get an ID code from the
  100.      user.
  101.  
  102.      * Both high- and low-level protocol
  103.  
  104.      By acting both like a device and a library, AHI gives the programmer
  105.      a choice between full control and simplicity. The device API allows
  106.      several programs to use the audio hardware at the same time, and
  107.      the AUDIO: dos-device driver makes playing and recording sound very
  108.      simple for both the programmer and user.
  109.  
  110.      * Future Compatible
  111.  
  112.      When AmigaOS gets device-independent audio worth it's name, it should
  113.      not be too difficult to write a driver for AHI, allowing applications
  114.      using 'ahi.device' to automatically use the new OS interface. At
  115.      least I hope it wont.
  116.  
  117. SPECIAL REQUIREMENTS
  118.  
  119.      AmigaOS release 2.
  120.      MC68020 processor strongly recommended.
  121.  
  122. AVAILABILITY
  123.  
  124.      Aminet, for example:
  125.      ftp://ftp.germany.aminet.org/pub/aminet/dev/misc/ahidev.lha
  126.      ftp://ftp.germany.aminet.org/pub/aminet/mus/misc/ahiusr.lha
  127.      ftp://ftp.germany.aminet.org/pub/aminet/docs/misc/ahiman.lha
  128.  
  129.      WWW:
  130.      http://www.lysator.liu.se/~lcs/ahi.html
  131.  
  132. PRICE
  133.  
  134.      Free. But if you use it in a shareware of commercial product,
  135.      I would like a registered copy for me and each of the audio driver
  136.      authors (this is merely a wish, you don't have to do it if you don't
  137.      think we deserve it). See the AHI User's Guide for more information.
  138.  
  139. DISTRIBUTABILITY
  140.  
  141.      Copyright ©1994-1997 Martin Blom.
  142.      Freely distributable in unmodified form.
  143.      See the AHI User's Guide for more information.
  144.